home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 November / macformat-018.iso / Comms Spectacular / MacTCP / MacWeather / MacWeather Help < prev    next >
Encoding:
Text File  |  1994-07-25  |  9.8 KB  |  135 lines  |  [TEXT/ttxt]

  1. Introduction    
  2.  
  3. MacWeather allows you to connect to an Internet weather server to get current weather information and forecasts for a specified city.  It requires a Mac Plus or higher with System 7.0 and MacTCP. MacWeather is shareware -- see the notice at the end of this document regarding payment.
  4.  
  5.  
  6. What is MacTCP?
  7.  
  8. MacTCP is an extension that provides TCP/IP, a communications protocol which allows your computer to talk to other computers on the Internet. In order to use MacTCP, you must have some type of connection to the Internet -- either through a direct Ethernet connection or from a dial-up service with SLIP or PPP capabilities. MacTCP is currently a commercial product, but it will soon be bundled with System 7.5 when it is released. For now, the best way to get MacTCP is to get the book _Internet Starter Kit for Macintosh_ by Adam Engst. This book is also an excellent resource for people new to the Internet and provides far more information on getting connected than I could ever include here.
  9.  
  10.  
  11. Getting Started
  12.  
  13. When MacWeather runs for the first time, it will bring up the preferences screen so that you may choose what city to view. After selecting the desired preferences, the program will attempt to connect to the weather server and get the current information for the selected city. After making the connection, the current conditions and forecast are downloaded and displayed on the screen. You can cancel the download process at any time by pressing command-period. When MacWeather starts up the next time, it will automatically get information for the current city without bringing up the preferences screen.
  14.  
  15. Selecting a city can be accomplished by several different ways. First, in the Preferences window, you select the primary city using the pop-up menus. MacWeather will automatically get information for this city when it first starts up. In future versions of MacWeather, the hourly weather conditions for the primary city will be logged to a file to observe trends in temperature, barometric pressure, etc. At this time, I do not plan to add graphing support within MacWeather, but you may read the log files into any graphing program for viewing. 
  16.  
  17. The second method of selecing a city is by using the Location pull-down menu. Any city chosen from the Location menu is a secondary city. Use this menu to switch temporarily to different cities of interest without changing the primary city setting. After you choose the city to view by using the City menu within the Location pull-down menu, MacWeather will automatically get information on that city.
  18.  
  19. The last method of selecting a city is by using the Recent menu within the Location menu. The Recent menu shows the primary city as the first menu item. If any secondary cities have been selected, they are shown below the primary city, separated by a dotted line. Use this menu to switch quickly between the last few cities viewed. When a new city is selected, MacWeather automatically gets infomation on that city.
  20.  
  21.  
  22. Features
  23.  
  24. The following is an explanation of the major features of MacWeather. Extensive Balloon Help is also available to give specific help on any area you desire.
  25.  
  26. The large analog window is your main display for city conditions. The title bar indicates the name of the city in question. The top line of the window displays status messages when MacWeather connects to the weather server. After successfully retrieving the weather information, the status bar shows the time of the reported conditions. Double-clicking on the status bar is a shortcut to the city selection card of the Preferences.
  27.  
  28. The thermometer and barometer show the current temperature and pressure, respectively. The symbols at the bottom of the instruments indicate the direction that the temperature or pressure has changed since the last reading. The wind indicator shows the direction from which the wind is blowing, with the wind speed displayed in the center. Double-clicking in any of these instruments is a shortcut to the appropriate Preferences card for setting minimum and maximum values and units to display.
  29.  
  30. Below the wind indicator is an iconic representation of the current conditions. The text below the icon also gives a short description of the conditions. Finally, the instrument in the lower right corner displays the percent relative humidity. For those of you whose desktop space is scarce, you can also view this information in condensed form using the digital window.
  31.  
  32. For cities in the United States and Canada, local forecasts are automatically downloaded with the current weather conditions. The forecast is displayed by choosing the Show Forecast menu item in the Weather menu. Forecasts are not available from the weather server for cities outside the Unites States and Canada.
  33.  
  34. Near shore marine forecasts are also available for selected cities in coastal areas of the United States. To retrieve marine forecasts, click the Get Marine Forecast checkbox in the City Selection Preferences card. Choose Show Marine Forecast from the Weather menu to view the current marine forecast.
  35.  
  36. Climate data is available for many cities in the United States. To retrieve climate data, click the Get Climate Data checkbox in the City Selection Preferences card. The data that is reported varies greatly depending on the city. Some cities do not report climate data; others report daily temperatures and sunrise/sunset information; still others give detailed reports of the recent trends in the local weather. Choose Show Climate Data from the Weather menu to view the current climate data.
  37.  
  38. The local forecast, marine forecast, and climate data call all be copied to the clipboard, saved as TeachText documents, or printed at any time.
  39.  
  40.  
  41. Getting Help    
  42.  
  43. Extensive balloon help is available to give brief descriptions of the various commands and their actions. This text is also accessible online by choosing the Help item in the Weather menu or the MacWeather Help item in the Balloon Help menu.
  44.  
  45.  
  46. Using Other Servers    
  47.  
  48. MacWeather is currently written only to work with the default weather server, downwind.sprl.umich.edu and its mirror server, madlab.sprl.umich.edu.  madlab is a newer machine and tends to have less downtime than downwind. However, not much testing of MacWeather has been done on madlab, so use it at your own risk. If you attempt to connect to a different server, very strange things may happen since MacWeather is designed to work with the output format from downwind and madlab. I am not aware of any other servers currently in operation that give data as informative as from those servers.
  49.  
  50.  
  51. Version History    
  52.  
  53. 2.0.2    July 25, 1994
  54.     •    Removed PowerPC native code -- lots more testing necessary
  55.  
  56. 2.0.1    July 25, 1994
  57.     •    Fixed a bug which caused crashes when parsing forecasts
  58.  
  59. 2.0        July 24, 1994
  60.     •    Added support for hPa and km/h
  61.     •    Added support for tons of new cities in the US and abroad
  62.     •    Added support for near-short marine forecasts in the US
  63.     •    Added support for climatic data in the US
  64.     •    Added nighttime icons
  65.     •    Added support for saving and printing forecasts
  66.     •    Added Recent menu to switch between cities easily
  67.     •    Added Default button for preferences
  68.     •    Added support for firewalls (still buggy)
  69.     •    Added units to wind speed display
  70.     •    Redrew displays to make them look a little better
  71.     •    Numerous minor bug fixes
  72.  
  73. 1.1.1  March 8, 1994
  74.     •    Fixed a bug caused by the last bug fix when conditions hadn't changed
  75.     •    Fixed a bug with mouse clicks in the City Code edit field
  76.     •    Increased the size of the thermometer and barometer slightly in preparation for minimum/maximum marks
  77.  
  78. 1.1   March 7, 1994
  79.     •    Enabled copying from forecast window
  80.     •    Rewrote icon picking code -- hopefully it now recognizes most of them
  81.     •    Removed alert message for no icon available
  82.     •    Fixed a few bugs related to edit boxes in the prefs window
  83.     •    Added Location menu
  84.     •    Fixed a bug which caused the forecast to be erased when conditions hadn't changed
  85.     •    Added smaller digital display
  86.  
  87. 1.0   February 27, 1994
  88.     •    First public release
  89.  
  90.  
  91. To Do List    
  92.  
  93. •    Support for Apple Script
  94. •    Support for Apple Guide
  95. •    Log conditions for primary city to file
  96. •    Option to put temperature (or whatever you want) in menu bar
  97. •    Clean up of data presented in the various forecast windows
  98. •    Add sliders for daily min/max of temperature and pressure
  99.  
  100.  
  101. Acknowledgments    
  102.  
  103. I would like to thank the people who helped to make all of this possible. 
  104.     Icon Design:            Dexter T. Kobayashi (aka "Killer Bunny")
  105.     Beta Testers:        Christopher Bailey                                            Eben Haber
  106.                                                                             Paul Celestin                                                                John Linthicum
  107.                                                                             Jerome "The Evil Tofu" Chan        Victor Menayang
  108.                                                                             Rob Dewhirst                                                                    John Moulder
  109.                                                                             David Farber                                                                    Steve Nelson
  110.                                                                             Barry Fishman                                                                David Negro
  111.                                                                             Michael Fraase                                                            Marcel Portanger
  112.                                                                             Mike Griggs                                                                        Michael Wellman
  113.                                                                             Scott Gruby                                                                        Edward Wolpert
  114.     Firewall Testers:    Shawn Ramer
  115.                                                                     Jay Thomas
  116.                                                                     Scott Walker
  117.  
  118.  
  119. Shareware Notice    
  120.  
  121. MacWeather is shareware.  If you like it, please send $10 to:
  122.     Christopher Kidwell
  123.     3405 Tulane Drive, Apt. 2
  124.     Hyattsville, MD 20783
  125.  
  126. Please include your E-mail address if you have one. Acknowledgements of payment are typically sent via E-mail within a few days of receipt. If you do not get mail from me, please send me mail -- your mail address may have been missing or unreadable. Registered users are updates via E-mail when they are released and also get special information about planned features and problems with the weather server.
  127.  
  128. Site license information is available upon request.
  129.  
  130. Bug reports may be mailed in or sent via E-mail to:
  131.   kidwell@wam.umd.edu
  132.  
  133. MacWeather is Copyright © 1994 by Christopher Kidwell. All rights reserved.
  134. MacWeather may be distributed freely as long as it is not modified in any way.
  135.